moving options

diff --git a/xmldoc/formats/bcr.xml b/xmldoc/formats/bcr.xml
index d5117d50b34761ae41216aefbdf1d5270d85ec85..c5604099d73ed73beddfd5820c8d09be222cbbb5 100644 (file)
--- a/xmldoc/formats/bcr.xml
+++ b/xmldoc/formats/bcr.xml
@@ -1,34 +1,21 @@
-
-      
-      
-      <para> This file format (extension .bcr) is used in "Motorrad
-Routenplaner 2002-..." by Map&amp;Guide. It is a route-onle
-format. If you own a newer release (2005...) you can also use the XML
-export and convert via <command moreinfo="none">gpsbabel ... -i tef
-...</command> to your preferred format.  May be there are other
-products from Map&amp;Guide using the format.
+<para> 
+This file format (extension .bcr) is used in Map&amp;Guide 
+<productname>Motorrad Routenplaner 2002</productname> and later versions. 
+BCR is a route-only format. If you own a newer release (2005 or later) you 
+may also use the XML export with GPSBabel's <link linkend="fmt_tef">tef</link> 
+input format.  
 </para>
-      <para> Coordinates are stored in Mercator format. The
-calculation between this and our internal format can result in visible
-differences.  Experience reports are welcome.</para>
-      <para>   Options:</para>
-      <para>
-            <option>index</option> - If more then one route are
-present in source data, with this option you can determine, which of
-this should used for the output. The range is 1 to number routes in
-input.  If you don't use this, only the first route will be converted.
+<para>
+There may be other products from Map&amp;Guide that use this format as well.
 </para>
-      <para>
-            <option>name</option> - Not every input format has a real
-name for routes in their data. So you can give the route a nice
-name.</para>
-      <para>
-            <option>radius</option> - Overwrites the default value of
-6371000.0 meters for the earth radius. My be this can help to reduce
-differences.</para>
-      <para/>
-      <example id="sample_bcr_command">
-       <title>Sample BCR command with all options</title>
-       <screen format="linespecific">gpsbabel -r -i gpx -f in.gpx -o bcr,index=1,name="From A to B",radius=6371012 -F a_to_b.bcr </screen>
-      </example>
+<para> 
+Coordinates are stored in a BCR file in a Mercator projection. The
+conversion from the Mercator projection to polar (latitude/longitude) 
+coordinates and back again may result in visible differences.  Experience 
+reports are welcome.
+</para>
+<example id="sample_bcr_command">
+  <title>Sample BCR command with all options</title>
+  <screen format="linespecific">gpsbabel -r -i gpx -f in.gpx -o bcr,index=1,name="From A to B",radius=6371012 -F a_to_b.bcr</screen>
+</example>
     

diff --git a/xmldoc/formats/options/bcr-index.xml b/xmldoc/formats/options/bcr-index.xml
index 8b137891791fe96927ad78e64b0aad7bded08bdc..2d981b38b292e3b06cdef938a76c60c998cf0437 100644 (file)
--- a/xmldoc/formats/options/bcr-index.xml
+++ b/xmldoc/formats/options/bcr-index.xml
@@ -1 +1,9 @@
+<para>
+Because the format supports only one route, this option may be used 
+on output to select a single route from a collection of 
+routes read from a more expressive format.  If you have, say, a 
+<link linkend="fmt_gpx">gpx</link> file that contains two routes, you may
+use this option to write them one at a time to individual files.
+</para>
+<screen format="linespecific">gpsbabel -i gpx -f routes.gpx -o bcr,index=1 -F route1.bcr -o bcr,index=2 -F route2.bcr</screen>
 

diff --git a/xmldoc/formats/options/bcr-name.xml b/xmldoc/formats/options/bcr-name.xml
index 8b137891791fe96927ad78e64b0aad7bded08bdc..575866e3a70456c1753a0d7395371a879d2d3335 100644 (file)
--- a/xmldoc/formats/options/bcr-name.xml
+++ b/xmldoc/formats/options/bcr-name.xml
@@ -1 +1,5 @@
-
+<para>
+This route specifies the name of the route.  This is particularly useful if
+the route came from an input format that did not support named routes, but 
+it may also be used to rename a route.
+</para>

diff --git a/xmldoc/formats/options/bcr-radius.xml b/xmldoc/formats/options/bcr-radius.xml
index 8b137891791fe96927ad78e64b0aad7bded08bdc..db96ea032cb45f470b2fc6f86e7959c9e12080f8 100644 (file)
--- a/xmldoc/formats/options/bcr-radius.xml
+++ b/xmldoc/formats/options/bcr-radius.xml
@@ -1 +1,9 @@
-
+<para>
+This options instructs GPSBabel to use a different value for the radius of 
+the earth when converting between the Mercator projection and geographic 
+coordinates.  The default value is 6371000.0 meters.
+</para>
+<para>
+Careful experimentation with this value may help to reduce conversion
+errors.
+</para>